home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / vpjam122.zip / jamapi.doc < prev    next >
Text File  |  1997-06-16  |  4KB  |  87 lines
  1.               VPJAM - a JAM API for Virtual Pascal, Version 1.22
  2.                  for Virtual Pascal for OS/2, Version 1.10
  3.      Copyright (C) 1996-97 Dusk To Dawn Computing. All Rights Reserved
  4.  
  5. 1. Introduction: (What is JAM?)
  6. ~~~~~~~~~~~~~~~~
  7.    JAM is a format for message systems, primarily FidoNet-style BBS systems.
  8. It was created in 1993 by Joaquim Homrighausen, Andrew Milner, Mats Birch,
  9. and Mats Wallin to be a new standard for FidoNet message bases, and as a way
  10. to replace the older Hudson message base.  It was first implemented in
  11. Milner's BBS software, RemoteAccess.  It is an advanced message architecture,
  12. supporting multiple file attachments, nearly unlimited message size (Up to 2
  13. gigabytes per message), password protection, complete reply tracking,
  14. programmer-defined message subfields for any purpose necessary, and quite a
  15. bit more than can be described in this paragraph.  :)
  16.  
  17. 2. Disclaimer:
  18. ~~~~~~~~~~~~~~
  19.    VPJAM is guaranteed only to take up disk space.  Though this unit has been
  20. thoroughly tested on my machine, I have no way of knowing what your setup is;
  21. and as always, if it breaks, you have the pieces.
  22.  
  23. 3. About this implementation:
  24. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  25.    My version of the JAM API was created so that I could write my BBS
  26. software, Aspect/2.  I wanted to support JAM and SquishMail bases, but didn't
  27. have a JAM API for OS/2, and especially one for Virtual Pascal...It took me
  28. quite a while to find the original JAM API for DOS, which thankfully included
  29. a Turbo Pascal version.  I used the TP version as a template for my own
  30. version (although many things are implemented in a more Pascal-like manner in
  31. my version), while I had to implement a few things on my own (Like the Unix
  32. time conversion routines).
  33.  
  34. 4. Installation
  35. ~~~~~~~~~~~~~~~
  36.    Basically, run the installation program, pick the directories you want the
  37. various components to be installed into, and let it go. You should then be
  38. able to use the library.
  39.  
  40. 4. Files included:
  41. ~~~~~~~~~~~~~~~~~~
  42.  
  43. Unit files:
  44.    JAM.LIB/VPI       Declarations and record definitions
  45.    JAMMB.LIB/VPI     The actual message base object class
  46.    JAMINFO.LIB/VPI   Utility functions for included sample message viewer
  47.  
  48.    D2DCRC.LIB/VPI    Dusk To Dawn Computing's CRC32 unit
  49.    UNIXTIME.LIB/VPI  Dusk To Dawn Computing's tDateTime <-> tUnixTime unit
  50.  
  51. Source files:
  52.    JAM.INT           Interface for declarations and record definitions
  53.    JAMMB.INT         Public interface for message base object
  54.    JAMINFO.PAS       Source for utility functions used in sample viewer
  55.    JAMUTILP.PAS      Source for sample JAM message base viewer
  56.  
  57.    D2DCRC.INT        Public interface for CRC32 unit
  58.    UNIXTIME.INT      Public interface for UnixTime unit
  59.  
  60. Resource files:
  61.    JAM.H             C-style header file for JAM.RC
  62.    JAM.RC            RC.EXE source file for VPJAM's resources
  63.  
  64. Executables:
  65.    JAMUTILP.EXE      Sample JAM message base viewer/reader
  66.  
  67. 5. Using JAMAPI
  68. ~~~~~~~~~~~~~~~
  69. The only usage documentation included in this release is the sample message
  70. base viewer, the interfaces for the units, and the source for the JAMInfo unit.
  71. It's pretty well self-documenting code, so that shouldn't be too much of a
  72. problem, but if you have questions or problems in implementation, feel free
  73. to send me email about it.
  74.  
  75. Update: There is now a rudimentary set of documentation available on the Web
  76. at http://DuskNet.dyn.ml.org/Pascal/JamAPI/index.html -- I may, in a future
  77. release, include the HTML documentation in the VPJAM package.
  78.  
  79. 6. Contacting me
  80. ~~~~~~~~~~~~~~~~
  81. My E-mail address is deek@grfn.org. I can also sometimes be found in the
  82. EFnet IRC channel #OS/2 using the nickname "Deek".
  83.  
  84. If you have suggestions or have a bug to report, *please* E-Mail them to me,
  85. that way I can keep an archive of what suggestions I've looked at/worked
  86. on/added in, and I can also keep track of who suggested what.
  87.